home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / tmod610.zip / TMODEM.DOC < prev    next >
Text File  |  1991-04-26  |  43KB  |  1,173 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                    Tmodem
  31.                                  Version 6.10
  32.                           (C) Copyright 1989,90,91
  33.                            Micro TECH Systems, Inc.
  34.                               All Rights Reserved
  35.                                Table of Contents
  36.  
  37.          Limited Warranty                                  1
  38.          Distribution Policy and Copyright                 1
  39.          Copyright                                         1
  40.          Test Drive Distribution Policy                    1
  41.          Tmodem Command Line Switches                      1
  42.              /R                                            2
  43.              /U                                            3
  44.              /F                                            3
  45.              /K                                            4
  46.              /N                                            4
  47.              /P                                            4
  48.              /B                                            5
  49.              /X                                            6
  50.              /C                                            6
  51.              /@                                            6
  52.              /A                                            7
  53.          Required Switches                                 8
  54.              Receive Batch File                            8
  55.              MINIMUM command line for Receiving a file     8
  56.              Send Batch File                               8
  57.              MINUMUM command line for Sending a file       9
  58.          Errorlevels                                       9
  59.          Debug Messages                                    9
  60.          BBS/Terminal Programs                             9
  61.          Installation Setup and Debugging Tips            10
  62.               Installing Tmodem on A BBS                  10
  63.               Installing Tmodem on a Terminal Package     11
  64.          Terminal Interface Examples                      13
  65.               Telix                                       13
  66.                    Locked Serial Ports and Telix          14
  67.               Qmodem                                      15
  68.               QT 2000                                     15
  69.          Pcboard                                          16
  70.          SpitFire                                         16
  71.          Registering Tmodem                               19
  72.          Tmodem License                                   20
  73.          Tmodem                 ver 6.10                      Page  1
  74.  
  75.                                LIMITED WARRANTY
  76.  
  77.          This  product  is provided "as is" without  warranty  of  any
  78.          kind.   The entire risk as to the results and performance  of
  79.          the  program  is assumed by you.  Should  the  program  prove
  80.          defective,  you  (and not Micro TECH Systems,  Inc.  or  it's
  81.          dealers)  assume the entire cost of all necessary  servicing,
  82.          repair or correction.  Further, Micro TECH Systems, Inc. does
  83.          not warrant, guarantee, or make representations regarding the
  84.          use of, or the results of the use of this program in terms of
  85.          correctness,    accuracy,   reliability,   currentness,    or
  86.          otherwise;  and  you  rely on the program  and  it's  results
  87.          solely  at  your own risk.  Micro TECH Systems,  Inc.  cannot
  88.          accept  responsibility for system damage, loss of profit,  or
  89.          any  other  special,  incidental,  or  consequential   damage
  90.          resulting from the use or inability to use this product.
  91.  
  92.          Micro  TECH  Systems,  Inc., DOES  warrant  to  the  original
  93.          licensee of a REGISTERED product that the program disk(s)  on
  94.          which  the  program  is  recorded be  free  from  defects  in
  95.          materials and workmanship under normal use and service for  a
  96.          period  of  ninety  (90) days from the date  of  delivery  as
  97.          evidenced  by  a copy of your receipt.  Micro  TECH  Systems,
  98.          Inc.'s  entire liability and your exclusive remedy  shall  be
  99.          replacement  of  the  disk not meeting  Micro  TECH  Systems,
  100.          Inc.'s Limited Warranty.
  101.  
  102.                        DISTRIBUTION POLICY AND COPYRIGHT
  103.  
  104.                                    COPYRIGHT
  105.  
  106.          Regardless  of the method of marketing, Tmodem is not in  the
  107.          public  domain.   It is copyrighted by  Micro  TECH  Systems,
  108.          Inc..   All  rights  are  reserved.   Copying,   duplicating,
  109.          selling  or  otherwise distributing this  product  except  as
  110.          expressly  permitted  in the TEST-DRIVE  Distribution  Policy
  111.          below  is a violation of the Law.  However, we grant you  the
  112.          right,  in fact encourage you to make and distribute as  many
  113.          copies  of  this TEST-DRIVE version as you  wish,  using  any
  114.          acceptable medium of exchange, with the following provisions:
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.          Tmodem                 ver 6.00                      Page  2
  129.  
  130.                      -- TEST-DRIVE Distribution Policy --
  131.  
  132.           1.   Please feel free to distribute this TEST-DRIVE version as
  133.                often as you like, to any interested parties.
  134.           2.   Please do not distribute the program without all of its
  135.                original related files, addendum files, and documentation.
  136.           3.   Please obtain our written permission prior to distribution
  137.                with any "Bundled" software packages.
  138.           4.   Please do not accept payment for the program; a copying fee of
  139.                $10.00 per diskette may be charged when distributed by a
  140.                non-profit user-group.
  141.           5.   Please do not alter the program or documentation in any
  142.                manner.
  143.           6.   NOTE - Individuals, groups, vendors, or other software
  144.                distribution companies which market diskettes containing
  145.                the TEST-DRIVE programs for profit must obtain written
  146.                permission from Micro TECH Systems, Inc. prior to
  147.                distribution.
  148.  
  149.  
  150.                          Tmodem Command Line Switches
  151.  
  152.          Each  switch must be preceeded by either a forward slash  '/'
  153.          or a dash '-'.
  154.  
  155.          R   Receive File.
  156.          U   Place incoming files in this directory
  157.          F   Send these files
  158.          K   Keep aborted transfers
  159.          N   Node Number caller is on.
  160.          P   Com Port to use.
  161.          B   Connect Baud Rate
  162.          X   Trun log OFF
  163.          @   Name of text file containing names of files to send.
  164.          A   Calibrate Serial Port.
  165.          C   Cancel Error/Suggestion Screens.
  166.  
  167.                                       /R
  168.                                  Receive Files
  169.  
  170.  
  171.          When  Tmodem encounters this switch, it will go  directly  to
  172.          Receive files mode.
  173.  
  174.          Therefore,  the  /R switch MUST be the very last  switch  you
  175.          use.
  176.  
  177.          Inbound files will be placed in the current sub-directory.
  178.  
  179.          You may override this with the U switch.
  180.  
  181.  
  182.  
  183.          Tmodem                 ver 6.10                      Page  3
  184.  
  185.                                       /U
  186.                      Place inbound files in this directory
  187.  
  188.          The  default  is  to  place  inbound  files  in  the  current
  189.          directory.  /U  may be used to point files to  another  drive
  190.          and/or directory.
  191.  
  192.          Tmodem  verifies  that  this  is a  valid  directory  so  the
  193.          directory must be listed in the file allocation tables.
  194.  
  195.          Drive  designators or ROOT directories may not be  used  with
  196.          the /U switch.
  197.  
  198.          e.g.  /UC:  or  /UC:\ are not valid since they  do  not  have
  199.          directory entries and may not be validated.
  200.  
  201.          The /U path must NOT end with a backslash.
  202.  
  203.          e.g. d:\uploads\ is NOT valid.
  204.  
  205.          It should be d:\uploads
  206.  
  207.          Sample of a GOOD /U setting: /UC:\TELIX\UPLOADS
  208.  
  209.                                       /F
  210.                                Send These Files
  211.  
  212.          When  Tmodem encounters the /F, it will immediately  go  into
  213.          send  mode  and  begin sending the  files  following  the  /F
  214.          switch.  Therefore, the /F must be the last  Tmodem  parmeter
  215.          you use.
  216.  
  217.          You  MUST  place one space between the filename  and  the  /F
  218.          switch and there must also be one space between the filenames
  219.          themselves, if more than one.
  220.  
  221.          A  full  Drive/Path is accepted and any  wildcard  characters
  222.          will be expanded to match any files in that directory.
  223.  
  224.  
  225.          The  only limit placed on the /F is the one placed on  it  by
  226.          DOS.  You only have 128 characters you can use for a  command
  227.          line and only 9 DOS batch file parameters (%1 ... %9).
  228.  
  229.          Note  to WildCat! Sysops.... some later versions of  WildCat!
  230.          further complicate things by not correctly passing the  names
  231.          of the files to send, if you tell WildCat! the protocol is  a
  232.          BATCH protocol.
  233.  
  234.          Basically, it only sends the NAMES of the files, but does NOT
  235.          send the location of the files.
  236.  
  237.  
  238.          Tmodem                 ver 6.10                      Page  4
  239.  
  240.  
  241.          e.g.  TMOD610.EXE  would be the only  thing  WildCat!  sends.
  242.          TMOD610.EXE may be on Drive Q, F, G,... in any  sub-directory
  243.          on  any  one of those drives. It more or less  says  "Hey....
  244.          find  this  file... it's on the computer SOMEPLACE  and  send
  245.          it".
  246.  
  247.          Mustang  Software was contacted about this, but  flat  denied
  248.          that  WildCat!  did it. Don't know why they bothered  to  lie
  249.          about  it... it's easy to verify and was verfied by  a  dozen
  250.          WildCat! sysops....using simple DOS BATCH files to print  the
  251.          command line WildCat! was passing to their printers.
  252.  
  253.          We can fix it for you, just download the WildCat! archive  on
  254.          our BBS. It's a hell of a way to fix it and I'd rather switch
  255.          to a different BBS than have to put up with all of WildCat!'s
  256.          problems, but if you paid for it... I guess you're stuck with
  257.          it.
  258.                                       /K
  259.                             Keep Aborted Transfers
  260.  
  261.          Keep  aborted  transfers  due to carrier  lose  or  excessive
  262.          errors.  Keeping the file allows you to RESTART the  transfer
  263.          on your next call.
  264.  
  265.          The  default is to NOT keep aborted transfers and  /K  should
  266.          never be used if you are using Tmodem as an external protocol
  267.          with YOUR BBS.
  268.  
  269.                                       /N
  270.                                   Node Number
  271.  
  272.          This can only useed if you're running an Osiris SE Multi-Line
  273.          BBS.
  274.  
  275.          N must be followed by the node number the caller is on.
  276.  
  277.          e.g. /N1  /N2  /N3 ... /N255
  278.  
  279.          Tmodem will display the callers name, city, and state at  the
  280.          bottom of the screen.
  281.  
  282.                                       /P
  283.                                    Com Port
  284.  
  285.          This  is  the  COM port you're going to be  using.
  286.  
  287.          e.g. /P1  /P2  /P3 ... /P8
  288.  
  289.          Only P1 though P4 is valid for NON-Osiris SE systems.
  290.  
  291.          If  you're  running Tmodem with Osiris SE, you  may  use  /P5
  292.          though /P8
  293.          Tmodem                 ver 6.10                      Page  5
  294.  
  295.                                       /B
  296.                                Connect Baud Rate
  297.  
  298.          This  is the CONNECT (Notice the capital letters)  baud  rate
  299.          that your currently at.
  300.  
  301.          Valid baud rate settings are: 300, 1200, 2400, and 9600.
  302.  
  303.          Tmodem REQUIRES that you tell it the TRUE CONNECT RATE.  Most
  304.          of the time this is the same as your SERIAL baud rate.
  305.  
  306.          e.g. /B1200  /B2400  /B9600
  307.  
  308.          NOTE: If you're using a 3/12/2400 modem then you can skip the
  309.          rest of this section.
  310.  
  311.          The only time that it would NOT be the same is if you have  a
  312.          highspeed  modem with a FIXED serial rate of 9600, 19200,  or
  313.          38400.
  314.  
  315.          In  which  case,  the CONNECT rate will  not  always  be  the
  316.          SERIAL rate.
  317.  
  318.          That  doesn't change anything, you still must pass  the  TRUE
  319.          connect rate and not the SERIAL rate.
  320.  
  321.          If your terminal program isn't capably of passing the CONNECT
  322.          rate (Telix for instants can not pass the CONNECT rate)  then
  323.          you must HARDCODE 0 in as the /B parameter.
  324.  
  325.          e.g. /B0
  326.  
  327.          Tmodem will then PROMPT you for the CONNECT rate.
  328.  
  329.          If  you're setting up Tmodem as an external BBS protocol  and
  330.          your  BBS can't pass the TRUE CONNECT rate (WildCat!  can't),
  331.          then   you'll   have  to  setup   THREE   external   protocol
  332.          definitions;  One  for  1200,  one  for  2400,  and  one  for
  333.          Highspeeds.
  334.  
  335.          I'm  sorry, but there simply is not anything that WE  can  do
  336.          about that. Tmodem is a "SMART" protocol that configures each
  337.          tranfer  according to the computer's speed,  modem  hardware,
  338.          connect  rate, line noise, etc. for each,  current,  transfer
  339.          and  only the BBS or Terminal program can supply the  CONNECT
  340.          rate. It can't be READ from any other location.
  341.  
  342.          The  next thing you'll need to do, if your running  a  LOCKED
  343.          serial  port,  is  to setup an  environment  variable  called
  344.          COMx=BaudRate,  replacing x with the serial port  number  and
  345.          BaudRate with the LOCKED baud rate.
  346.  
  347.          e.g. COM1=19200
  348.          Tmodem                 ver 6.10                      Page  6
  349.  
  350.          Do NOT add blank spaces, comma's, and make sure you use Upper
  351.          Case.
  352.  
  353.          Tmodem can support up to 115,000 baud using the combined COMx
  354.          and /B switch.
  355.  
  356.                                       /X
  357.                                  Turn off Log
  358.  
  359.          Tmodem  writes  a  log, in the current directory  or  in  the
  360.          Osiris  SE  root directory if Osiris SE is present.  The  log
  361.          contains the status of each transfer.
  362.  
  363.          If you do not want the log, /X will turn it off.
  364.  
  365.                                       /C
  366.                         Cancel error/suggestion screens
  367.  
  368.          Anytime a Transfer could not be started, for any reason...you
  369.          side  or the other side, Tmodem will attempt to  explain  why
  370.          and offer suggestions.
  371.  
  372.          Once  you have your system setup correctly, you may  want  to
  373.          turn this off to avoid delays.
  374.  
  375.                                      /@
  376.              Name of text file containing names of files to send.
  377.  
  378.          e.g. /@D:\OSIRIS\SEND2.CTL
  379.  
  380.          This  is the name of a TEXT file that contains the  names  of
  381.          the files to send. Full drive and path information is allowed
  382.          and  wildcard characters will be expanded to fit any file  in
  383.          that directory.
  384.  
  385.          As  soon  as  Tmodem encounters this switch,  it  will  begin
  386.          sending. Therefore it MUST be the last switch you use on  the
  387.          command line.
  388.  
  389.          This is the preferred method of passing file names to  Tmodem
  390.          if  you're using it as an external BBS protocol. This  allows
  391.          MORE  file  names  than you may be able to  fit  on  the  DOS
  392.          command line.
  393.  
  394.          There  is no limit, practical limit, to the number  of  files
  395.          that you can list.
  396.  
  397.          Each line in the file must contain only ONE filename and must
  398.          end with a DOS CR/LF sequence.
  399.  
  400.  
  401.  
  402.  
  403.          Tmodem                 ver 6.10                      Page  7
  404.  
  405.          e.g.
  406.  
  407.          C:\DRIVERS\MPT110.ZIP
  408.          C:\DRIVERS\TMOD610.ARJ
  409.          C:\DRIVERS\ZMOD*.*
  410.  
  411.          You may NOT intermix the /F and the /@
  412.  
  413.          Some  versions  of Pcboard will attempt to intermix  the  two
  414.          formats.  In other words, sometimes Pcboard will simply  pass
  415.          the  filenames,  sometimes  it will  pass  @LISTNAME  and  it
  416.          includes  @ as part of the filename making it impossible  for
  417.          you to configure a BATCH file that will work.
  418.  
  419.  
  420.          e.g.  if you attempted to do a /F %3 %4 %5 with Pcboard,  you
  421.          may  get  a  send  then again Pcboard  may  decide  to  place
  422.          @D:\PCBOARD\SEND.CTL  in %3. In which case, Tmodem will  SEND
  423.          that file instead of using it as a SEND Ctrl file because  it
  424.          followed  the /F which indicating that it was a file to  SEND
  425.          and not USE.
  426.  
  427.  
  428.          We  have a supplemental program available called  PCboard.lzh
  429.          (zip  or arj) that will intercept PCboard's command line  and
  430.          construct the correct TYPE of command line for Tmodem. It  is
  431.          available  for downloading on our CBIS system to any  Pcboard
  432.          sysop  that  wants it. Using it very easy and  requires  very
  433.          little in the way of additional installation procedures.
  434.  
  435.                                       /A
  436.                              Calibrate Serial Port
  437.  
  438.          On some systems, the uarts are slightly off by 1 - 3 pbs.  In
  439.          other words, when you open the serial port to 19200 baud,  it
  440.          actual opens to 19202 baud.
  441.  
  442.          Normally  this wouldn't poss any type of problem,  but  since
  443.          Tmodem  customizes the send and the hardware is part  of  the
  444.          equation, it does.
  445.  
  446.          /A  tells Tmodem that this MAY be a problem and to  calibrate
  447.          the serial port before doing the system analysis.
  448.  
  449.          If you have everything else setup properly and still can't do
  450.          a transfer, try adding this switch.
  451.  
  452.          It doesn't HURT or slow down anything so you may add it  even
  453.          if you don't really need it.
  454.  
  455.  
  456.  
  457.  
  458.          Tmodem                 ver 6.10                      Page  8
  459.  
  460.                                Required Switches
  461.  
  462.          Each  Tmodem installation will require TWO switches,  doesn't
  463.          matter  what type of BBS/Terminal program you're going to  be
  464.          using or whither or not it is a SEND or RECEIVE batch file.
  465.  
  466.          /Bxxxxx and /Px
  467.  
  468.          Replacing  xxxxx  in  the /B (CONNECT  BAUD  RATE)  with  the
  469.          correct CONNECT rate or 0 and replacing the x in /P with  the
  470.          correct COM port.
  471.  
  472.          e.g. /B9600 /P2  (Connect Rate 9600, COM 2)
  473.          e.g. /B2400 /P1  (Connect Rate 2400, COM 1)
  474.  
  475.          The  POSITION  of  the switches  aren't  important  with  ONE
  476.          exception, the /B or the /P can _NOT_ be the LAST switch  on
  477.          the the command line.
  478.  
  479.                             Your Receive Batch File
  480.  
  481.          Your  Receive  Batch file will require  only  one  additional
  482.          switch, /R
  483.  
  484.          It MUST be the very last switch on the command line.
  485.  
  486.          The  MINIMUM command line for receiving would be:
  487.  
  488.          Tmodem /B2400 /P1 /R
  489.  
  490.          The  2400 (Connect Rate) and the 1 (Com Port Nubmer)  may  be
  491.          supplied by DOS batch variables.
  492.  
  493.          e.g. Tmodem /B%1 /P%2 /R
  494.  
  495.          Or they may be supplied by any other means at your disposal.
  496.  
  497.          Other  optional  switches (/U for instants) may  be  included
  498.          BEFORE the /R switch.
  499.  
  500.          Make sure there is at LEAST one space between switches.
  501.  
  502.                                 Send Batch File
  503.  
  504.          Your SEND batch file only requires one additional switch:
  505.  
  506.          /F
  507.          or
  508.          /@
  509.  
  510.          Either switch MUST be the last switch on the command line.
  511.  
  512.  
  513.          Tmodem                 ver 6.10                      Page  9
  514.  
  515.          The MINUMUM command line for sending a file:
  516.  
  517.          /B2400 /P2 /F FILENAME#1 FILENAME#2 FILENAME#3
  518.  
  519.          or
  520.  
  521.          /B2400 /P2 /@CTRL_NAME
  522.  
  523.          The 2400 (Connect Rate), the 2 (Com Port Nubmer), FILENAME#1,
  524.          FILENAME#2,  FILENAME#3,  etc. may be supplied by  DOS  batch
  525.          variables.
  526.  
  527.          e.g. Tmodem /B%1 /P%2 /F %3 %4 %5 %6 %7 %8 %9
  528.  
  529.          Or they may be supplied by any other means at your disposal.
  530.  
  531.                                   Errorlevels
  532.  
  533.          Tmodem exits with 2 errorlevels, 0 if files were  transferred
  534.          or received and 1 if no files or transfers where sent.
  535.  
  536.                                 Debug Messages
  537.  
  538.          Tmodem  will display a number of ERROR messages when  missing
  539.          important or required command line switches.
  540.  
  541.          i.e. Missing or Illegal Baud Rate.
  542.  
  543.          The   messages   are  quite  plain  and   need   no   further
  544.          explanations. Reference The Section(s) of this document  that
  545.          deal with that particular command line setting.
  546.  
  547.                              BBS/Terminal Programs
  548.  
  549.          Tmodem  uses  very basic command line  switches  that  should
  550.          allow  it  to  run  with almost ANY type  of  BBS  system  or
  551.          Terminal  program. We can not nor do we make make any  claims
  552.          that  it WILL work with EVERY Single BBS or Terminal  program
  553.          out.
  554.  
  555.          Please  limit  technical  questions  to  Tmodem  itself.  Our
  556.          Technical Support staff will not be able to answer  questions
  557.          concerning 3rd party software, i.e. Pcboard, Qmodem, Wildcat,
  558.          regarding  HOW  those programs go about  supporting  external
  559.          protocols. We've included ALL the information KNOWN by US  in
  560.          this documentation.
  561.  
  562.          If  you have problems interfacing Tmodem with 3rd party,  you
  563.          should  contact Micro TECH Systems, Inc. to verify  that  the
  564.          TMODEM  command line switches are accurate then  contact  the
  565.          distributors  of  the software your attempting  to  interface
  566.          Tmodem with to verify THEIR methods of passing information to
  567.          external protocols.
  568.          Tmodem                 ver 6.10                      Page 10
  569.  
  570.                      Installation Setup and Debugging Tips
  571.  
  572.          The  single largest problem with installing Tmodem  has  been
  573.          incorrect /B parameters. We can't stress this strong  enough,
  574.          you  MUST pass the connect baud rate and NOT the LOCKED  baud
  575.          rate.
  576.  
  577.          There  are  simply  TO many  different  BBS  programs  *we're
  578.          currently  aware  of  104 different  BBS  programs  in  use*,
  579.          versions of the SAME BBS program, and not to mention Terminal
  580.          programs  to  provide  any 100 percent  solution  to  HOW  to
  581.          install Tmodem on all of them.
  582.  
  583.                           Installing Tmodem on A BBS
  584.  
  585.          Make  sure  you read the Tmodem.doc file at least  twice  and
  586.          write  down all the command line switches, even if you  don't
  587.          think  you'll need them all. This helps a LOT and lowers  the
  588.          chances  that  you may overlook that one little  switch  that
  589.          will make Tmodem work with your software.
  590.  
  591.          e.g.  Certain  versions of Pcboard  requires  newly  uploaded
  592.          files  to  be  placed  in a  specific  directory,  many   BBS
  593.          programs require that. But, Pcboard does not change INTO that
  594.          directory  before  calling the external  protocol  driver.  A
  595.          Pcboard  sysop  not KNOWING this, may spend hours,  days,  or
  596.          never  be  able  to  get  an  external  protocol  driver  not
  597.          SPECIFICALLY  written  for Pcboard to work.  Several  PCboard
  598.          sysops, figuring this out, have spent hours working on  batch
  599.          files to switch in and out of that directory for uploads.
  600.  
  601.          All  they  REALLY  needed to do with use the  /U  switch  and
  602.          Tmodem  would  have done it all for them. They  just  assumed
  603.          that Tmodem couldn't do it...they didn't read the  Tmodem.doc
  604.          is what happened. They just 'scanned' it, like many do.
  605.  
  606.          Never  attempt to install TMODEM as an external  protocol  in
  607.          you  terminal software AND on your BBS at the same time.
  608.  
  609.          You  WILL need to have Tmodem already installed and  debugged
  610.          at  ALL  baud  rates  (if you have a  9600+  modem)  in  your
  611.          terminal package before attempting to install and debug it on
  612.          your BBS.
  613.  
  614.          Find a BBS that you KNOW has Tmodem installed, correctly, and
  615.          test  your terminal setup at 2400 and at 9600 (if you have  a
  616.          9600  baud modem) by transferring files to and from the  BBS.
  617.          Make sure you have it tested on SEND and RECEIVE.
  618.  
  619.          This way, when you do install it on your own BBS  you'll know
  620.          for SURE which side has the incorrect setup.
  621.  
  622.  
  623.          Tmodem                 ver 6.10                      Page 11
  624.  
  625.          If  you  don't KNOW a BBS that has it  setup  correctly,  try
  626.          ours at 1-314-334-6359.
  627.  
  628.          This  may  seem  silly, but it isn't and can  save  you  many
  629.          hours  of debugging work.
  630.  
  631.  
  632.                     Installing Tmodem on a Terminal Package
  633.  
  634.          The   best   thing  is  to  READ   your   terminal   programs
  635.          documentation on HOW to install external programs and exactly
  636.          HOW  and  WHAT your terminal program passes  in  respects  to
  637.          command line arguments.
  638.  
  639.          Each  terminal program does this a little  differently.  Some
  640.          VERSIONS of the same terminal program do it differently.
  641.  
  642.          Keeping in mind that Tmodem REQUIRES 3 switches ;
  643.  
  644.          These two are ALWAYS used in BOTH batch files.
  645.  
  646.          /Bxxxx with xxxx being the CONNECT baud rate
  647.          /Px  with x being the COM Port
  648.  
  649.          your 3rd REQUIRED switch (and remembering it must be the LAST
  650.          one on the command line) will vary.
  651.  
  652.          Your Receive batch file will use /R
  653.          Your SEND batch file will use  /F <Filename>
  654.  
  655.                   <Filename> is the NAME of the file to Send.
  656.  
  657.          Your  receive  batch file can also have, recommended  by  not
  658.          required,  a /K to keep aborted transfers and to  RESUME  the
  659.          transfer at a later date.
  660.  
  661.          You'll be using DOS BATCH parameters the % sign and either  a
  662.          1,  2,  3,  ....  and 9 to pass  the  information  from  your
  663.          terminal program to Tmodem.
  664.  
  665.          e.g. Tmodem /K /B%1 /P%2 /R
  666.          e.g. Tmodem /B%1 /P%2 /F %3 %4 %5 %6 %7 %8 %9
  667.  
  668.          The  number  following  the percent sign can  and  will  vary
  669.          depending  on your terminal software and even the version  of
  670.          your terminal software. That's why we can't TELL you what  to
  671.          use for a specific program, so please don't ask us.
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.          Tmodem                 ver 6.10                      Page 12
  679.  
  680.  
  681.          There  is an EASY method you can use to FIGURE all that  out.
  682.  
  683.          Place  the following line in both the SEND and RECEIVE  batch
  684.          files.
  685.  
  686.          Echo %1 %2 %3 %4 %5 %6 %7 %8 %9
  687.          pause
  688.          Tmodem <your normal command line>
  689.  
  690.          The line beginning with the 'Echo' will show you exactly WHAT
  691.          your terminal program is passing and in which % variable. You
  692.          can then adjust your Tmodem command line so that the REQUIRED
  693.          arguments are supplied by the correct percent variable.
  694.  
  695.          The  BIGGEST single problem is passing the CONNECT baud  rate
  696.          to  Tmodem  when  a 9600 baud modem is  used.  Some  Terminal
  697.          programs (telix for instants) aren't written to handle  smart
  698.          protocols  and will pass the SERIAL baud rate instead of  the
  699.          connect  baud rate.  This isn't acceptable and  you'll  never
  700.          get a transfer started if this happens.
  701.  
  702.          It's  easy  to debug this problem using the  above  Debugging
  703.          example. If the %x variable your using to pass the baud  rate
  704.          contains  9600,  19200, or 38400 when you call  a  2400  baud
  705.          system,  then your terminal program wasn't written to  handle
  706.          smart protocols.
  707.  
  708.          NOTE: Some terminal programs (Qmodem for instants) offer your
  709.          TWO  % variables for baud rate, one is the CONNECT  rate  and
  710.          one is the SERIAL rate. Check your Terminal documentations.
  711.  
  712.          The  answer  to  the problem is : Hard code 0 in  as  the  /B
  713.          parameter and let Tmodem prompt you for the connect rate.
  714.  
  715.          e.g. Tmodem /B0 /P%2 /R
  716.  
  717.          Another  common problem associated with high speed modems  is
  718.          not letting Tmodem KNOW you have a locked serial port.
  719.  
  720.          Be  sure you set the COMx=LOCKRATE in your  environment.  You
  721.          can  do  that  by  including one of  the  following  in  your
  722.          autoexec.bat file. Select one that reflects your serial  port
  723.          and lock rate.
  724.  
  725.  
  726.          SET COM1=9600
  727.          SET COM2=9600
  728.          SET COM3=9600
  729.          SET COM4=9600
  730.  
  731.  
  732.  
  733.          Tmodem                 ver 6.10                      Page 13
  734.  
  735.          SET COM1=19200
  736.          SET COM2=19200
  737.          SET COM3=19200
  738.          SET COM4=19200
  739.  
  740.          SET COM1=38400
  741.          SET COM2=38400
  742.          SET COM3=38400
  743.          SET COM4=38400
  744.  
  745.  
  746.          You will need to REBOOT your computer for the set command  to
  747.          take effect.
  748.  
  749.          The next thing you should do is test your setup on a BBS that
  750.          you KNOW has tmodem setup correctly.
  751.  
  752.          It would be very frustrating to spending hours attempting  to
  753.          debug your installation only to find out, if you ever do that
  754.          is, that the problem was on the BBS side ALL THE TIME.
  755.  
  756.          If  you  don't know of a BBS that your dead sure  has  TMODEM
  757.          installed correctly, try our BBS at 1-314-334-6359.
  758.  
  759.  
  760.                          Terminal Interface Examples
  761.  
  762.                                      Telix
  763.  
  764.  
  765.          Installing Tmodem as an External Protocol under Telix can be
  766.          easy.
  767.  
  768.          If  you have a 300, 1200, or 2400 baud modem you'll need two
  769.          batch files, one to send and one to receive.
  770.  
  771.          Tsend is for Sending file(s) and Trcv.bat is setup to RECEIVE
  772.          files.
  773.  
  774.          Trcv.bat calls Tmodem :
  775.  
  776.          Tmodem -K -UC:\UPLOADS -B%1 -P%2 -R
  777.  
  778.          Notice the -UC:\UPLOADS
  779.  
  780.          This is an optional switch that directs all up files received
  781.          to a holding directory called C:\UPLOADS
  782.  
  783.          If you have a different, and you most likely will,  directory
  784.          you  have  new files you download go to then change  that  to
  785.          suit your system.
  786.  
  787.  
  788.          Tmodem                 ver 6.10                      Page 14
  789.  
  790.          If  you  want  the  new  downloads  placed  in  the   current
  791.          directory,then leave the -U C:\UPLOADS off all together.
  792.  
  793.          i.e. Tmodem -K -B%1 -P%2 -R
  794.  
  795.          Trcv.bat calls Tmodem :
  796.  
  797.          Tmodem -B%1 -P%2 -F %3
  798.  
  799.                          Locked Serial Ports and Telix
  800.  
  801.          First  thing  you  do  is set up  a  COMx=LOCK_RATE  in  your
  802.          environment.  Assuming  Com 2 is used and the  lock  rate  is
  803.          19,200 baud.
  804.  
  805.                                 SET COM2=19200
  806.  
  807.          This statement should be placed in your autoexec.bat file and
  808.          will  be used by ALL of OUR protocol drivers and a number  of
  809.          other drivers.
  810.  
  811.          Those using Telix with a Fixed DTE rate (Locked serial  port)
  812.          have a problem. Telix always passes the SERIAL rate in the %1
  813.          variable. As outlined earlier, that's fine for most protocols
  814.          like  zmodem, puma, etc. but not for a Smart protocol.
  815.  
  816.          The  method  you'll need to use is simply, but  does  require
  817.          that  you  pay attention to the CONNECT message  telix  gives
  818.          you.
  819.  
  820.          In other words, when you call a 2400 baud system, the connect
  821.          message  will be connect 2400. You'll need to know that  when
  822.          you use Tmodem.
  823.  
  824.          You'll need to take your two batch files, Tsend and  Trcv.bat
  825.          and make a couple of small modifications.
  826.  
  827.          Trcv.bat calls Tmodem :
  828.  
  829.          Tmodem -K -UC:\UPLOADS -B0 -P%2 -R
  830.  
  831.          Notice that the %1 following the -B has been replaced with  a
  832.          0 (zero).
  833.  
  834.          This  tells Tmodem that the program that is CALLING it  isn't
  835.          capable  of  passing the TRUE connect rate. Tmodem  will  pop
  836.          open a small window in the middle of the screen displaying  4
  837.          connect rate options. You select the one that is correct  for
  838.          the current connects.
  839.  
  840.          You'll  need to make the same modifications to the  Tsend.bat
  841.          file.
  842.  
  843.          Tmodem                 ver 6.10                      Page 15
  844.  
  845.                                     Qmodem
  846.  
  847.  
  848.  
  849.                              300/1200/2400 Modems
  850.                 9600 Baud Modem, running a FLOATING serial Port
  851.  
  852.          Qmodem External Download file for Tmodem.
  853.  
  854.          <TDN.BAT>
  855.          Tmodem -B%3 -P%2 -K -R
  856.          Exit
  857.  
  858.  
  859.          Qmodem External Upload file for Tmodem.
  860.  
  861.          <TUP.BAT>
  862.          Tmodem -B%3 -P%2 -F %4
  863.          Exit
  864.  
  865.                  9600 Baud Modem, running a LOCKED Serial Port
  866.  
  867.          Qmodem External Download file for Tmodem.
  868.  
  869.          <TDN.BAT>
  870.          Tmodem -A -B%3 -P%2 -K -R
  871.          Exit
  872.  
  873.  
  874.          Qmodem External Upload file for Tmodem.
  875.  
  876.          <TUP.BAT>
  877.          Tmodem -A -B%3 -P%2 -F %4
  878.          Exit
  879.  
  880.  
  881.                                     QT 2000
  882.  
  883.                           Protocol Definition Record
  884.  
  885.          Send : -B*B -P*P -F *F
  886.          RCV  : -K -B*B -P*P -R
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.          Tmodem                 ver 6.10                      Page 16
  899.  
  900.                                     NOTICE
  901.  
  902.                    Micro TECH Systems, Inc. makes no  claims
  903.                    nor will Micro TECH Systems, Inc.  accept
  904.                    any  responsibility for the  accuracy  of
  905.                    the PcBoard examples. They were SUBMITTED
  906.                    by  a Pcboard sysop and included  without
  907.                    modifications.
  908.  
  909.                                     Pcboard
  910.  
  911.  
  912.          (PCBRT.BAT)
  913.          echo off
  914.          echo %1 %2 %3 %4
  915.          copy pass.txt pcbpass.txt
  916.          e:
  917.          cd\ed11
  918.          tmodem -B%4 -P1 -R
  919.          cd\
  920.          c:
  921.          cd\pcb
  922.  
  923.  
  924.  
  925.          (PCBST.BAT)
  926.  
  927.          echo off
  928.          echo %1 %2 %3 %4
  929.          tmodem -B%4 -P1 -F %3
  930.  
  931.                    Micro TECH Systems, Inc. makes no  claims
  932.                    nor will Micro TECH Systems, Inc.  accept
  933.                    any  responsibility for the  accuracy  of
  934.                    the   SpitFire   examples.   They    were
  935.                    SUBMITTED   by  a  SpitFire   sysop   and
  936.                    included without modifications.
  937.  
  938.  
  939.                                  SpitFire BBS
  940.  
  941.  
  942.          NOTE the -U Switch, it is -UC:\SF\EXTERNAL
  943.          DO NOT!!!  ADD ..   IF EXIST %3 ERASE %3  ,IF YOU DO THAT
  944.          The Files Will Dissapear!...,make SURE the -U Switch
  945.          is set at -Uc:\sf\EXTERNAL !!!!
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.          Tmodem                 ver 6.10                      Page 17
  954.  
  955.          (SFEXTUPB.BAT)
  956.  
  957.          BRK OFF
  958.          Echo Off
  959.          CD\SF\EXTERNAL
  960.          TMODEM -B%1 -P%2 -UC:\SF\EXTERNAL -R
  961.          IF ERRORLEVEL 1 GOTO END
  962.          IF ERRORLEVEL 0 GOTO GOOD
  963.          GOTO END
  964.          :GOOD
  965.          muv %3 %4
  966.          SFLOGIT        TMODEM used!
  967.          :END
  968.          CD\SF
  969.          BRK ON
  970.  
  971.          (SFEXTDNC.BAT)
  972.  
  973.          BRK OFF
  974.          ECHO OFF
  975.          CD\SF\EXTERNAL
  976.          TMODEM -B%1 -P%2 -F %3
  977.          IF ERRORLEVEL 1 GOTO END
  978.          IF ERRORLEVEL 0 GOTO GOOD
  979.          GOTO END
  980.          :GOOD
  981.          SFLOGIT        Tmodem Used!
  982.          :END
  983.          IF EXIST %3 ERASE %3
  984.          CD\SF
  985.          BRK ON
  986.  
  987.          (SFEXTDND.BAT)
  988.  
  989.          Echo Off
  990.          BRK OFF
  991.          CD\SF\EXTERNAL
  992.          TMODEM -B%1 -P%2 -F %3 %4 %5 %6 %7 %8 %9
  993.          IF ERRORLEVEL 1 GOTO END
  994.          IF ERRORLEVEL 0 GOTO GOOD
  995.          GOTO END
  996.          :GOOD
  997.          SFLOGIT        Tmodem Used!
  998.          :END
  999.          If EXIST %3 ERASE %3
  1000.          IF EXIST %4 ERASE %4
  1001.          IF EXIST %5 ERASE %5
  1002.          IF EXIST %6 ERASE %6
  1003.          IF EXIST %7 ERASE %7
  1004.          IF EXIST %8 ERASE %8
  1005.          IF EXIST %9 ERASE %9
  1006.          CD\SF
  1007.          BRK ON
  1008.          Tmodem                 ver 6.10                      Page 18
  1009.  
  1010.          (SFEXTUP.BBS)
  1011.  
  1012.          <A> ZModem
  1013.          <B> TModem
  1014.          <C> ZModem Batch,Batch
  1015.  
  1016.          (SFEXTDN.BBS)
  1017.  
  1018.          <A> ZModem
  1019.          <B> ZModem Batch,Batch
  1020.          <C> TModem
  1021.          <D> TModem Batch,Batch
  1022.  
  1023.          NOTE: If you install Tmodem on any BBS program not listed and
  1024.          would  like to share your installation setup, type it up  and
  1025.          upload  it to our BBS. We will include it, unaltered, in  the
  1026.          next release of the documentation.
  1027.  
  1028.  
  1029. ****************************************************************************
  1030.                    I M P O R T A N T  S O  R E A D  T H I S !
  1031.  
  1032.                               LIMITED SHAREWARE.
  1033.  
  1034.          Tmodem  is what we refer to as LIMITED SHAREWARE which  means
  1035.          that you can try almost all the features before you  purchase
  1036.          it. Features that will not work.
  1037.  
  1038.          Batch  Downloads: You can not RECEIVE Batches of  Files.  You
  1039.          will  be limited to only one file per download. If  you  tell
  1040.          the  BBS  to  send  more than one, only  the  first  will  be
  1041.          accepted.
  1042.  
  1043.                    PLEASE  do  not  call  our  Tech  Support
  1044.                    number and leave messages that you  can't
  1045.                    get  Batch Receives to work with  a  NON-
  1046.                    REGISTERED version of Tmodem, they aren't
  1047.                    suppose to.
  1048.  
  1049.          Restart Recover: You may not resume an interrupted transfer.
  1050.          This should NOT be confused with error recover. Resuming an
  1051.          interrupted transfer means picking up on a file you started
  1052.          but was aborted because carrier was lost.
  1053.  
  1054.  
  1055. ****************************************************************************
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.          Tmodem                 ver 6.10                      Page 19
  1064.  
  1065.  
  1066.                              Registering Tmodem
  1067.  
  1068.                            ($15.00 you download Key)
  1069.               ($25.00 for Disk with Latest Version Mailed to You)
  1070.  
  1071.          Fill out the Order.Frm and Mail To :
  1072.  
  1073.                               Micro TECH Systems
  1074.                              555 North Spring, #39
  1075.                            Cape Girardeau Mo. 63701
  1076.  
  1077.                               $15.00 Registration
  1078.  
  1079.          Or you may UPLOAD the order.frm to our CBIS system at
  1080.          1-314-334-6359 or register ONLINE via the Online Store(tm)
  1081.          with Visa or Master card.
  1082.  
  1083.                    Orders  upload  to the system  or  placed
  1084.                    within the Online Store(tm) requires  one
  1085.                    working day to process.
  1086.  
  1087.          On the Order.frm you'll find a field that asks you to enter a
  1088.          password for downloading your key.
  1089.  
  1090.          Once we receive your order, we'll generate a special KEY that
  1091.          Tmodem will read that unlocks the registered features. Your
  1092.          key will be placed in a a special directory on our CBIS and
  1093.          password protected using the password you supplied in the
  1094.          Order.Frm.
  1095.  
  1096.                    Please  do  NOT request  that  our  sysop
  1097.                    Email  or Upload the key to  your  system
  1098.                    under the 15.00 plan. If you not wish  to
  1099.                    pickup  your  key,  use  the  25.00  plan
  1100.                    listed below.
  1101.  
  1102.                               $25.00 Registration
  1103.  
  1104.          We'll  send you the key on a 5 1/2 360K diskette  along  with
  1105.          the latest version of Tmodem. Sorry for the extra 10  dollars
  1106.          but  now  we've  got labor, mailing  fees,  disks,  and  disk
  1107.          mailers involved.
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.          Tmodem                 ver 6.10                      Page 20
  1119.  
  1120.                                Tmodem License
  1121.  
  1122.                              Please Read Carefully
  1123.  
  1124.          By   registering  Tmodem, you indicate your   acceptance   of
  1125.          these terms.
  1126.  
  1127.          Tmodem  ("the Software") is copyright 1989, 90, 91 by   Micro
  1128.          TECH   Systems,   Inc.   All   rights  are   reserved.    The
  1129.          PURCHASER   is granted  a LICENSE to use the  software  only,
  1130.          subject  to  the following restrictions and limitations.
  1131.  
  1132.          1. The license is to the original purchaser only, and is  not
  1133.          transferable   without  written  permission  of  Micro   TECH
  1134.          Systems, Inc.
  1135.  
  1136.          2.  The  original purchase may use the Software on  a  single
  1137.          computer or single Local Area Network owned or leased by  the
  1138.          original purchaser.
  1139.  
  1140.          You may not use the software on more than one computer or one
  1141.          Local  Area  Network  even if you own or lease  all  of  them
  1142.          without the written consent of Micro TECH Systems, Inc.
  1143.  
  1144.          3.  The  original purchaser may make back-up  copies  of  the
  1145.          Software  for  his or her own use only, subject  to  the  use
  1146.          limitations in this license.
  1147.  
  1148.          4. The original purchaser may not engage in, or permit  third
  1149.          parties to engage in, any of the following:
  1150.  
  1151.                    A. Providing or permitting use of or disclosing the
  1152.                    Software to third parties.
  1153.  
  1154.                    B. Making alterations or copies of any kind in  the
  1155.                    Software (except as specifically permitted above).
  1156.  
  1157.                    C. Attempting to Un-assemble, de-compile or reverse
  1158.                    engineer the Software in any way.
  1159.  
  1160.                    D. Granting sublicenses, leases, or other rights in
  1161.                    the Software to others.
  1162.  
  1163.  
  1164.  
  1165.          Micro  TECH  Systems  reserves the right  to  terminate  this
  1166.          license  if there is a violation of its terms or  default  by
  1167.          the  Original Purchaser. Upon termination, all copies of  the
  1168.          Software must be immediately returned to Micro TECH  Systems,
  1169.          and  the  Original Purchaser shall be liable  to  Micro  TECH
  1170.          Systems  for any and all damages suffered as a result of  the
  1171.          violation or default.
  1172.  
  1173.